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TSSS 



TIME SHARING SUPPORT SYSTEM 



DEFINITIONS 

TSSS restricted to system programmers with authority codes or P 
RSS— resident support system (suspends TSS/360) 
VSS-virtual support system (executes within TSS/360) 

Programmer Classifications 

MSP -master system programmer, uses RSS; only one MSP connected 

to system at a time 
TSP-task system programmer, uses VSS and, indirectly, RSS; several 

attached to system at one time, but only one per task 

INVOKING TSSS 



Result 

MSP connected at operator's terminal, $ written 

at terminal to invite TSSS input, RSS mode; 

TSS/360 execution suspended 

TSP connected at same user terminal, $ written 

at terminal to invite input, VSS mode for task; 

task execution suspended 

TSP connected at terminal of specified task, $ 

written at terminal to invite input, VSS mode 

for specified task; task execution suspended 

, RSS only, can be issued only by MSP 



Action 

External interrupt 
key pressed 

VSS command at 
user terminal 

CONNECT command 
issued by MSP 
followed by RUN 
or DISCONNECT* 
*CONNECT command, 

QUALIFICATION 

Address Qualification 

real storage addresses-$RM 
virtual storage addresses— $VM 

external storage addresses— implied secondary storage address in 
operand 

Command Qualification 

Indicates private or global (public) AT statements; MSPs and TSPs 
implant ATs in real, virtual, or shared virtual storage; ATs implanted 
by RSS (for MSP or TSP) are globally qualified; those implanted by 
VSS (for TSP) in shared virtual storage can be optionally qualified 
as global. 

Qualification Relationships 



Issued 
by 


In 

storage 
(type) 


Implanted 
by 


Qualifi- 
cation 
assigned 


AT-Table 


TSP 


Global 


RSS 


TSP 
TSP 

MSP 
MSP 
MSP 


real 

virtual 

virtual 

(shared) 

real 

virtual 

virtual 

(shared) 


RSS 

VSS 
VSS 

RSS 
RSS 
RSS 


global 
private 
private 
global 
global 
global 
global 


X 

X 


X 


X 

X 
X 

X 



SYNTAX 

The following operators and symbols are used with TSSS commands: 
Operators 

Arithmetic Operators 

+ (addition) 

— (subtraction) 

x (multiplication) 

/ (division) 
Boolean operators 

& (and) 

I (or) 

"> (not) 
Relational operators 

< (less than) 

> (greater than) 

= (equal to) 

Symbols 

External symbols— reference specific data fields (in real or virtual stor- 
age) 
SP symbols-symbolic names, used by system programmers in TSSS as: 

• identifications of (temporary) defined data fields 

• pseudonyms for TSS/360 data fields or I/O devices 

Specified as: character string; one-to-eight alphameric characters, 
first alphabetic 
System symbols-when used in command statement operands, pre- 
defined TSSS symbols reference specific data fields or perform cer- 
tain functions 

Formats for system-symbol specification 



SRM[(n)] [.] 
SVM[(n)][.] 
SB (sp symbol) 
$P (sp symbol) 
$L (sp symbol) 
$T (sp symbol) 
$S (sp symbol) 
$R(n) 
$C(n) 
$E(n) 
$DHDR 



STASK (taskid) 



real memory 

virtual memory 

base address, field containing 

pointer 

length 

typejhex=01, char=02, dec=03? 
size 

general-purpose registers n=0-15 
extended-control registers n=0-15 
floating-point machine registers n=0,2,4, or 6 
used with SET command; establishes label for out- 
put of DUMP command; maximum header length, 
80 bytes. 

SET $DHDR='SAMPLE OF TSSS DUMP' 
used with DUMP command to produce formatted 
dump of a task's status indicators; if no taskid speci- 
fied, current task assumed: 
Print Line 
Number 



1 

2 

3 

4 

5,6,7 

8,9, 10 

11,12 

13, 14, 15, 16 

17-21 

22-34 



Contents 

primary header 

SDHDR 

taskid, user IDF 

current PSW 

general registers 

control registers 

floating-point registers 

old virtual PSWs 

TSI 

TSI header 



PSW symbols in 

$PSW 

$PPSW 

$SPSW 

$XPSW 

$IPSW 

SMPSW 

PSW symbols in 

$PSW 

$PPSW1 

$PPSW2 

$SPSW 

$XPSW 

$APSW 

$IPSW 

$TPSW 

$VPSW 

For MSP only 

$CAW 

$csw 

$TASKID 



RSS 

current PSW 

program interrupt old PSW 
supervisor call interrupt old PSW 
external interrupt old PSW 
1/0 interrupt old PSW 
machine-check interrupt old PSW 
VSS 
current VPSW 

recoverable data set paging error VPSW 
program interrupt old VPSW 
supervisor call interrupt old VPSW 
external interrupt old VPSW 
asynchronous I/O interrupt old VPSW 
I/O interrupt old VPSW 
timer interrupt old VPSW 
VSS activation old VPSW 

channel address word 
channel status word 

foT MSP identification number of task that was cur- 
rent when RSS received control 
forTSP identification number of TSPs current task 
i CSECT,PSECT,ENTRY ) 
$ID(L'xxxxxxxx')used to obtain < POINT (RM) iname 

/ CSECT,PSECT (VM) ) 
whose address is nearest to but not greater than the 
address specified by 'xxxxxxxx' 
$MAP used to obtain dump of TSS/360 supervisor or a 

specific task 

C'xxx' 
X'xxx' 
$IO| \ sp symbol 
decimal 
integer 

Note: $IO, used with SET command, allows user to 
card.to-tape: SET $IO (X<0182>$IO(X l OOOO 

terminal-to-tape: SET$IO(X'0182')=C'AT INTPROC COLLECT 
COLAREA=$lPSW> 

(/ C'xxxx* 
jdeci X m X annteg e r>['>'n -«>JA<> 
\ sp symbol 

$DOUT< X ' xxxx ' A 

i sp symbol j 

SDOUT = device for DUMP commands 

Vused with DISPLAY, DUMP, or REMOVE 



; ,„ [number of records], mode set 
| ,cylinder,track[, record,] 



[(o,l,t,s)] 



$AT[. location] 
$PATCH [.location] 



SSTATUS used with DUMP command to produce formatted dumi 


all system-status indicators; 


Print Line 




Number 


Contents 


1 


primary header 


2 


$DHDR 


3 


taskid, CPUid 


4 


current PSW 


5,6,7 


general registers 


8, 9, 10 


control registers 


11, 12 


floating-point registers 


13, 14, 15 


old PSWs 


16 


channel address word, channel status word 


17-21 


TSI 


22-34 


XTSI header 


Data Fields 





Data fields are defined by: 
Symbols -system, external, and SP 

Absolute addresses-Hexadecimal storage addresses (in real or virtual 

storage) referenced using L-notation. 

Format : L'xxxxxxxx' Implied Attributes : o=0 

1=1 byte 

t=hex 

s=l byte 

Indirect Addressing— multiple levels of indirect addressing may be speci- 
fied with % sign 
Format: data field % 



where data field is generalized representation of all types of symbols 
and other means of designating storage addresses 

Subscripting-array name and subscript used to reference element in 

array 

Format : data field (m) 

m=0 will point to first element in array; in general, m=(x-l) will point 
to x" 1 element in array 

Range-an address range 
Format : data field j : data field2 

Immediate Attribute Designation— To define or change implicit attri- 
butes use "immediate attribute designation" 
Format: data field (o,l,t,s) 
where o = offset 



1 = length 
t = type 
s = size 



i I = decimal integer I 
/ X = hexadecimal / 
J C = character 1 



Literal data -immediate data in input stream that becomes content of 
nonaddressable field 



Type 
Decimal 



Max Value 

->3 1 



Implied Length 



Example 
128 



2* l - 1 4 bytes 

Hexadecimal determined by length in maximum length X'134abc' 

256-byte input buffer of 256 bytes 
Character not applicable specified C'CHAR""S' 

number of 
characters 

Constant data-address constants only; value equals storage address of 
symbol; specified as: A 'symbol' 



TSSS Command Functions 



Command 


Function 


AT 


Designates point in program where AT statement 




is to be executed 


CALL 


Initiates execution of prestored set of command 




statements 


COLLECT 


Moves data from specified area into specified col- 




lection area 


CONNECT 


Issued by MSP only; TSP is connected to VSS at 




terminal of specified task 


DEFINE 


Defines temporary symbols and allocates neces- 




sary storage 


DISCONNECT 


Disconnects TSSS capability from terminal; re- 




stores TSS/360 (except for patches); permanent- 




ly transfers control to TSS/360 


DISPLAY 


Writes data on terminal 


DUMP 


Writes data on specified output device 


END 


Terminates reading of input device used for pre- 




stored statement sets 


IF 


Designates conditional statement: if condition 




satisfied, statement is executed 


PATCH 


Alters contents of specified data Held; keeps rec- 




ord of patches 


QUALIFY 


Establishes implicit qualification (real memory, 




virtual memory, or global) for subsequent 




operands 


REMOVE 


Deletes ATs and associated dynamic statements, 




or deletes patches 


RUN 


Transfers control to TSS/360; ATs can then be 




executed 


SET 


Alters content of specified data field 


STOP 


Halts TSS/360 or specific task 



TSSS COMMANDS 



Command 


Operands 


AT 


/L.'xxxxxxxx' \ j- -i 

addre S s) extern ^Y mbol > ,- 
\ sp symbol l 

'system symbol / *- -1 


CALL 


/ X'xxxx' \ 

JC'xxxx' f 
J Sp symbol / 
V decimal integer-device address * 


COLLECT 


~°'={^r} [-■] 


CONNECT 

(executed by 
MSP only) 


/ sp symbol i 

task I/D number = <j $TSKID > 

1 constant / 


DEFINE (format 1) 
(format 2) 


sp symbol [.(o,l,t,s)] [,...] 

^external symbol \r 

^H *"">><>' r oMs> 

* address-L'xxxxxxxx'/ "- 


- -i 


DISCONNECT 


none 


DISPLAY 


/ data field \r 1 
1 literal [['""J 


DUMP 


/ data field \r 1 
^literal (['""J 


END 


none 


IF 


expression 


PATCH 


da< afi e W1 ={™«J[,...] 


QUALIFY 


1 real $RM[(n)) [.command operand] 1 
< virtual $VM[(n)j [.command operand] > 
1 global $RM[(n)] 1 


REMOVE 


f SAT ) 
\ $PATCH f 


- /external symbol] -, 
l sp symbol f 

\ system symbol t 

- [ L'xxxxxxxx 1 ; _ 






RUN 


/ external symbol \ 

address- r P SymbGl > 
j system symbol ( 

\ L'xxxxxxxx* ; 




SET 


^ fi ^{™ d2 }[•■••] 


STOP 


none 


vss 


user identification code 



EXAMPLES OF TSSS USAGE 

Displaying storage areas 

1. display any area on direct access device 

/ symbolic de-) 

DISPLAY $10 (C'< vice addr > 'cylinder, track, 

laetualaddr ) 

record). (o,l,t,s) 
defaults: If (cylinder, track, record) any of these is defaulted, all to 
right are defaulted; default for offset (o)=0, length (1)=1, type 
(t)=hex, size (s)=l byte 

2. display byte '3A* on cylinder 0, track=l, record=l: 
DISPLAY $IO(C'12^0,1,1).(X'3A , ) 

3. display a register 
DISPLAY $r( 15) 

4. display range of real core by use of literals 
DISPLAY L'lAC: L'22C 

5. display range of VM by use of literals 
DISPLAY $VM.L'15004'.(,20) in hex format 
DISPLAY $VM.L'15004'.(,20,C) in character format 

6. display range of VM using symbols 
DISPLAY $VM.CZAHAR.(X'166',1) 

7. display owner ID of location in core 
user: DISPLAY $ID (L'2B988') 
system: CHBSTE2B988 

Dumping storage areas 

1. dump range in core by use of literals 

DUMP L'0':L7ffff (assumed dump of real core) 
DUMP L*0':L*7ffffffO' (virtual dump) 

2. dump range by use of symbols 
DUMP LABELLLABEL2 

3. dump range in VM when not certain of qualification 
DUMP $VM.L'0':$VM.L'10(Xr 

4. dump (in hex) VAM public VTOC on cylinder 
DUMP $IO(C'12\0) (in hex) 



(j X'physical path'} '° ) ' ( " C) 



DUMP $10 

Note: Even with default for length=l („C) entire cylinder dumped in 

this case 
dump VM and real core, when not certain of qualifications, and get 
storage maps of both. 
QUALIFY $RM 

DUMP $MAP 

DUMP L'0':L'7ffff 

QUALIFY $VM 

DUMP $MAP 

DUMP L'0':L'7ffffffO' 



Modifying storage areas 

J. patch an area on a device; set byte '3A' on cylinder=0 5 track=l, 
record=l at SDA=12 equal to X'40' 
SET $IO (C12',0,l,l).(X'3a') = X'40' 

2. change VAM disk ID on SDA=22 
SET$IO(C'22\0,0,3).(8,6) = CNARESC 

3. patch area in user code, VM (e.g., restb] header for specific taskid) 
SET $VM(X'0014').L 4 90AFBQ'= X*C3' 

Assign tape device for dumps 
$SETDOUT=$IO(C43') 

Indirect addressing 

1. display registers in XTSI of the current task (when qualified for 
$RM)' 

DISPLAY L l 188'%.(X'C')%.(X i 50 , ,64) 

2. display contents of area pointed to by register 13, offset by 20 
(when qualified for $RM) 

DISPLAY SR(13)%.(X'20',20) 
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ASSEMBLER 



SYSTEM MACRO INSTRUCTIONS 

This section contains the system programmer oriented macro instruc- 
tions. It contains alphabetic listings of the macro instructions with then- 
definitions and formats. 

MACRO INSTRUCTION DEFINITIONS 

ACCTSUBR- accounting subroutine call 

ADDEV add device to task symbolic device list 

ADDPG-add virtual storage pages 

ADSPG— add shared virtual storage pages 

A TCS — activate terminal communication subprocessor 

ATPOL— poll for pending attention interrupt 

ATTACH -attach a task to the system 

AUXSET-create overload/overdraw interrupt control blocks 

A VAUX -available auxiliary remaining count 

AWAIT -wait for interrupt 

CANCL— cancel real-time interruption 

CHANGE-change schedule table entry 

CHECK— wait for, test for completion of read or write 

CKALOC- check for terminal MTT status 

CKCLS -check protection class 

CLEARQ 1 clear terminal device status 

CLIC-read command from SYSIN 

CLIP-read command from SYSIN 

CLOSE (M SAM) -disconnect data set from user's problem program 

CLOSE (TAM)- remove communication lines from use 

CNSEG— connect segment to shared page table 

CONN connect a muititerminal task 

CRTS I -create task status index 

DCB (MSAM)-set up data control block 

DCB (TAM)-set up data control block 

DCBD specify DCB DSECT 

DCLASS- specify privilege class 

DCON -disconnect a muititerminal task 

DDEF— define data set 

DELET -enter delete program 

DELPG -delete virtual storage pages 

DFTRMENT-define polling list 

DLINK -transfer to dynamic loader for external symbol resolution 

DLTSI-delete task status index 

DSSEG -disconnect shared page table from segment 

ENTER -enter privileged service routine 

ERROR-indicate supervisor-detected error 

FINDDS-locate JFCB corresponding to data set name 

FINDJFCB -locate JFCB and ensure volume mounting 

FINDQ find terminal requiring work 

FINISH (MSAM)-end of data set 

FREEQ —drop a terminal device 

GET (MSAM)-get record 

HASH -develop hash value for symbol 

INVOKE transfer control 

IOC A L -I/O call 

ITI— inhibit task interrupts 

LCD -indicate line code 

LIBESRCH— locate program module in external library 

LSCHP— list changed virtual storage pages 

LVPSW— load virtual program status word 

MQVXP move page table entries 

OPEN (MSAM)— prepare data control block for processing 

OPEN (TAM) -prepare DCB for processing 



1 for use only in MTT application programs 

13 



PSCVC— enter program control system 

PGOUT-write virtual storage pages to external storage 

PRESENT-prcsent current schedule level 

PTI-permit task interrupts 

PULSE— pulse schedule table entry level 

PURGE— purge I/O operations 

PUT (MSA M) -put record 

RCR -resource control instruction 

RCR OPEN 

RCR CLOSE 

RCR UPDATE 

RCR RATION 

RCR VACATE 

RCR LOGOFF 

RDI— reset drum interlock 

READ (TAM)-read from another terminal 

READQ —initiate read operation to terminal 

REDTIM-read elapsed real time 

RESET— reset device supression flag 

RESUME— return to calling program 

RJELC-remote job entry line control 

RMDEV -remove device from task symbolic device list 

RSPRV-restore privilege 

RSTTIM— reset system time 

RTRN-enter command analyzer to end run 

SAMPLE— sample system status table 

SCHED-schedule table entry 

SCR TSI -special create-task status index 

SETAE— set asynchronous entry 

SETSYS-set system table field 

SETTIMER— set real-time intervals from resident program 

SETTOD-set time of day 

SETTR -set real time interval 

SETTU-set user timer 

SETUP-set up task status index field 

SETUR— unit record device set up 

SETYMD-set year, month, and day 

SETXP-set external page table entries 

SETXTS-set up extended task status index field 

SPATH -set I/O device path 

STORE-store register contents 

SYSER -indicate nonresident-program-detected error 

TSEND -force time slice end 

TWAIT-wait for terminal I/O interrupt 

UPDTUSER-update user tables 

USAGE -display resource usage statistics 

VSEND-send message to another task 

VSENDR-send message to task and await response 

WAIT 2 -wait for terminal stimuli 

WRITE (T AM) -write message 

WRITEQ 1 —write message to terminal 

XTRCT extract task status index field 

XTRSYS -extract system table field 

XTRTM -extract accumulated CPU time 

XTRXTS-extract extended task status index field 

ZEROSST-zero system status table 

Inner Macro Instructions 

CHDERMAC-generate error message 
CHDINNRA-general type-1 or type-2 linkage 
CHDPSECT -reserve storage for parameter list 

1 for use only in MTT application programs 
can be used in both TSS mode and MTT mode 
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MACRO INSTRUCTION FORMATS 



Name 


Operation 


Operands 


[symbol J 


ACCTSUBR 


none 


[symbol] 


ADDEV 


[ device number <j (() } J 


return data: if reg high-order bit = 1 ; 
exceeds allowable device limit 


(symbol! 


ADDPG 


[page count | V ^ e | ] 

i ,start address -addrx .half page protection! 

< class code r 

_ ' (Q) ^ 




code value definition 




A 1 both halfpages nonprivilcged 

read/write 
AB 4 first halfpage nonprivileged 

read/write, second halfpage 

nonprivileged read-only 
AC 7 first halfpage nonprivileged read, 

second halfpage privileged 
BA 2 first halfpage nonprivileged 

read-only, second halfpage 

privileged 
B 5 both halfpages nonprivileged 

read-only 
BC 8 first halfpage nonprivileged 

read-only, second halfpage 

privileged 
CA 3 first halfpage privileged, second 

halfpage nonprivileged read/write 
CB 6 first halfpage privileged, second 

halfpage nonprivileged read-only 
C 9 both halfpages privileged 


[symbol] 


ADSPG 


f ^ t 1 addrx) If ,( value) 

[ start {«I) }j[' pagecount {(0)} 

i shared page table number value, j 

'' \ protection class code / 

L U15) ) . 


] 


see ADDPG for codes 


| symbol] 


ATCS 


none 


note: preset registers and 1 with 

reg either the virtual storage address of 

TCT slot containing processing options 
or all Fs to denote FRLFQ ALL 
reg 1 when TCT slot indicates message to be 

sent with freeing option, should be set with 
address of message length followed bv text: 
otherwise set toO 


[symbol] 


ATPOL 


program address-addrx [,switch-addx] 




ATTACH 


none 


no TS1 match found 

xxxxxx virtual storage address of system TCI slot 


[symbol] 


AUXSET 


none 


[symbol] 


AVAUX 


[amount-value,] location-addr 
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Name 


Operation 


Operands 


[ symbol 1 


AWAIT 


none 


[symbol] 


CANCL 


[task status index acldress-(reg)j 

j i symbol ) 

.interruption rlne ad con > ~ )■ 

\ (reg) i 


return data: reg 1 5 set to X'15' for normal returns 


[symbol] 


CHANGE 


H<s> r r 






CHECK 


(see TAM) 


I symbol] 


CKALOC 


f" /comp-value\- 
devnbr Jdcv-value > 
L ((0) L 




return data: reg is set to 

a user currently has control of the terminal 

1 was in control of RTAM ; now under user 
control 

2 terminal is associated with MTT; control 
of I/O is not given to user 

3 user control relinquished successfully 


[symbol] 


CKCLS 


1" start address^ 1 "*}] [halfpage count j^ 6 }] 

f .. ,, (VAR )1 
,segment length < . ,, > 
{ nonvanable ( 


return data: reg low-order byte set to 
code protection class 

page unassigned 

1 user read/write (least restrictive) 
3 user read only 

7 user cannot read or write (most restrictive) 


[symbol | 


CLEARQ 


relative line number-value 


return data: 

00 normal return 

04 invalid relative line numbei 

08 busy 

0C attention interruption received; 

normal clearing functions performed 


[symbol] 


CLIC 


none 


[symboll 


CLIP 


none 




CLOSE 


(see MSAM and TAM) 


[symbol] 


CNSEG 


~( segment number-value, shared page i" 
) table number-value > 




[symbol] 


CONN 


none 


note: registers 5 must be preset with the indicated 

reg parameter 

0,1 eight-character application program name in 

EBCDIC; if less than eight characters, pad 

with trailing blanks 

2 virtual storage address of first TCT slot 

3 virtual storage address of the first buffer page 
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Name 


Operation 


Operands 






4 left half-word contains maximum number 
oflines allowed simultaneous connection; 
right half-word contains buffer length 

5 left half-word is set to number of pages 
allocated for the TCT and buffer pages 

return data: low-order half-word of register is 
set to X'FFFF' if task already a multitetminal task 


[symbol] 


CRTS! 


none 


return data: reg 1 set to task ID or to O's if 
TSI limit exceeded 




DCB 


(seeMSAMorTAM) 




DCLASS 


(USER r 
Cd (PRIVILEGED) 




I symbol) 


Dt'ON 


none 


[symbol] 


DELET 


none 


[symbol] 


DELPG 


* i jj (addrx) 
start address-: > 


. ( value 1 

;P age count j (]) | J 






DFTRMENT 


(see TAM) 


[symbol] 


DLINK 


none 


[symbol] 


DLTSI 


none 


[symbol] 


DSSEG 


shared page table number J I 




] symbol) 


ENTER 


none (reg. 15 must be preloaded with enter 
code; see table of enter codes. 
following in this section.) 


[symbol] 


ERROR 


errtype-code, compat-integer, opt-integer, 
idno-integer 


code definition 

1 minor software error 

2 major software error 

3 hardware failure 


[symbol] 


FINDDS 


dsname-addr, byte-addr, area-addr 


return data: 
reg. 15 = code 
(hex) definition 
00 JFCB found or created 
04 no JFCB found; no request to create one 
08 no JFCB found; request to create one, but 

no dsname in catalog 
0C no JFCB found; DDEFeould not create one; 
space unavailable 


[symbol] 


FINDJFCB 


ddname-addr.byte-addr,area-addr 


[symbol] 


F1NDQ 


I relative line number-value] 


return data: 

code meaning 

00 no work 

04 invalid relative line number 

08 initial connection of device 

0C attention received from terminal device 

10 solid I/O error on terminal line 

14 message out, complete 

1 8 message in, complete 
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Name i Operation 


Operands 




FINISH 


(see MSAM) 


i symbol 1 


I RLhQ 


(relative line number-value} 
(ALL f 

(, message poinler-addr] 
j. disconnect^ 


return data: 

reg 15 = code n 
00 n 
04 i 


--♦--.«:■■■-;_; 




ormal re 

ivalid re 


ative line number 




GET 


(see MSAM) 


[symbol] 


HASH 


name, value 


[symbol] 


INVOKE 


address program adcon-addrx 


[symbol] 


ITI 


none 


1 symbol] 


LCD 


SDA = symbolic device address 


return data: low-ordc 
of the following cock 

code meaning 


r byte of register is set to one 


00 no entry for specified SDA 

01 1050 PTTC/8 (folded) 

02 2741 Correspondence (folded) 

03 2741 PTTC/8 (folded I 

04 teletypewriter ASCII (folded) 

05 1052-7 EBCDIC 


[symbol] 


LIBESRCH 


list-addr,not found exit-addr 


return data: 9 words of information loaded into 
address at list-addr+3 


[symbol] 


LSCHP 


. . i addrx ) 

L start { (i) /_ 




^ (value) 
jP age count j (Q) | 




return data: page condition code for page 

'n' is set In bits 2n-2 and 2n-l in reg 0; 

bit 

pair definition 

00 page in core changed 

01 page in core unchanged 

1 page not in core changed 

1 1 page not in core unchanged 


[symbol] 


LVPSW 


TpSW address j a ^M 




[symbol] 


MOVXP 


[star, address^** }][,o address {■£"}] 
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MSAM (multiple sequential access method) 



Operation 



Operands 



[symbol] 
[symbol] 



CLOSE 
DCB 



[symbol] 



[symbol] 



[symbol] 

[symbol] 



OPEN 
PUT 



(deb addr....) 

DSORG = Ms[,MACRF=|p | ]'[ .DDNAMIi = alphnar 

[J)EVD=codcl |,RECFM=code| [,LRHCL=absexp| 

rRY=jJ5fj[,COMBINE=J^j^OCKEl|2 |j 



,formtype=<s > 
Id) 



In! 



«}][■» 



,MODE=p J. | |,STACK=^2 

1 1 



,PRTSP= 



1 I 



i 3 



jddname-symboll DS0RG=ps 



,DSNAME=data set name,UNlT= 



Note ; For additional optional parameters, s 
Qir.Uk <- ...i.J-- l-.n Um.t. 



("addrx \ 
dcb{ (]) j" 




return data: 

reg 1 5 = code definition 




normal completion 
4 I/O not completed; reissue FINISH 
until different return code received 
8 complete with 1/0 error 


(addr) F (addrx) 1 

dcb { ( i)}L' arK, U> }j 




return data: 

reg 15 = code definition 




normal completion 
4 I/O not complete; reissue GET 
8 unrecoverable I/O error occurred 
12 endof file; reissue FINISH 

16 control card sensed 


[ j(dcb-addr.[(opt-eode)LJ . 


)1 


, , i addrx 1 ( addrx '( 
dcb{ (1) }^rea<j ((J) } 


1 


return data: 

reg 15 = code definition 




normal completion 
4 I/O not complete, r 


tissue PUT 



8 unrecoverable I/O error occurred 
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Name 


Operation 


Operands 


[symbol] 


MSAM 
SETUR 


(Continued) 

, . (addr'l faddr) 
dcb{ (1) |,param{ (()) \ 

return data: 

reg 15 =code definition 


normal completion 

4 operation not completed; reissue 
SETUR 

8 unrecoverable error occurred 
1 2 parameter is invalid SYSURS kev 
1 6 invalid buffer load key in SYSUCS 



[symbol] 


PCSVC 


none 


[symbol] 


PGOUT 


none 


return data: regO = four-bit group codes 

describing action of each page ; bits 0-3 first 

page, bits 4-7 second, etc. 

value definition 

0000 no error-page transmitted 

001 1 virtual storage page not assigned to task 

0100 request for zero pages 

0101 symbolic device not assigned to task 

0110 page in, bad device, volume is movable 

0111 page in , bad device, volume fixed 

1000 page in, medium failure 

100 1 page out, bad device, volume is movable 

1010 page out, bad device, volume fixed 

1011 page out, medium failure 


[symbol] 


PRESENT 


none 


[symbol] 


PTI 


none 


[symbol] 


PULSE 


none 


[symbol] 


PURGE 




i action-code, symbolic device numb 
.\(0) 

\ .task code ■? > [,taskid value] \ 
id) )_ 


"}] 


action codes are: 

AR purge all devices immediately 

AS purge all devices, let active ones quiesce 

AL purge all I/O requests immediatelv, leave 

TSDL alone 
AD remove the TSDL 
SR purge specified device after quiesce 
task codes mean: 
AT purge all tasks 
ST purge specified task only 




PUT 


(see MSAM) 


[symbol] 


RCR 


OPE.N,failur e -adci,[,us eri d^ d c d ; ium |j 

[«»H£^l][^"H;&*n.l] 

[MM 

CLOSE, failure-addr j^AUL entry {^maUd}] 
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Operation 



Operands 

UPDATE [gentry {^ vu ^ 

RATION, failure-addi, 

iCPU - CPU time (used with RATION only* 

CONN - terminal connect time 1 

TASK - a TSS background task ] 

STOR - permanent or temporary f 

external storage f 

DA - direct access device ^ 

MT - magnetic tape drive ( 

PTR - high speed printer l 

RPU - reader/punch 1 

BI - BULKIO records read in I 

BO - BULKIO records written out / 
[ ,amount- value] 



VACATE, type-code 



[, amount-value] ,user entry < j C ^ VLU \ 



\ .failure-addr} 



Note: Codes are indicated under RATION. 



LOGOFF, failure-addr 



[symbol] 



relative line number-valu 



lue [rRNSI ={y}J 
|" 1NTRPT = \ J j J I COMPSEL=value 



normal return 

invalid relative line number 

busy 

attention interruption icceived from 

solid error occurred duiing initiation 
of starting I/O 



[symbol] 



return data: regs & 1 = double-precision, 
fixed-point system time ii 



[symbol] 



device numbe: 



I value "i 
ci{*ALL'i 

I (Q) ) 



[symbol] 



[area-addrx,(regl-integer[,reg2-integer])l 
[,RC=integer] 
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Name 


Operation 


Operands 


I symbol] 


RJELC 


none 


note: registers and 1 must be preset with (lie values 

indicated 

reg - two byte hexadecimal number representing 

symbolic device address assigned during 

system generation 
reg 1 = code meaning 

prime the line 

1 enable the line 

2 disable the line 

return data: registers I and contain return data 
reg 1 = code meaning 

SIO successful 

4 SIO failed ; a Iso examine reg 

8 path unavailable or invalid input 

12 path busy 
when return code of 4 in reg 1 
regO= hits indication 

0- 1 SIO failure indication (not 

meaningful to macro instruction 
execution) 

2-3 TIO condition code 

4-5 TCI I condition code 

6 7 SIO condition code 

8 23 CSW status bvte (if SIO ce=l) 

24-31 Hags 

25 if on means control unit busy 

interruption was taken by 
another CPU 


[symbol] 


RMDEV 


r /dev-value \ ' 

device number Jcomp-vaIue> 
L ( (Q) J J 




return data: reg high-order bit= 1 if symbolic 
device number not found 


[symbol] 


RSPRV 


none 


[symbol] 


RSTTIM 


none 


[symbol] 


RTRN 


none 


[symbol] 


SAMPLE 


none 


[symbol] 


SCHED 


none 


[symbol] 


SCRTSI 


none 


return data: reg 1 = task I/D 


[symbol] 


SETAE 


[^""H'rtMT/}] 


[symbol] 


SETSYS 


Hnsi 




register 

notation implied 
code value length definition 
TOD 1 8 set time of day 
YMD 2 8 set years, months, days 
TASK1N1T 3 I set task initiation 
status field 
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Name 


Operation 


Operands 


[symbol] 


SETT1MER 


time/ ! nteg f r T \ , [ task status index-(reg)] 
\(reg [,reg])) 

)' symbol) 

, routine { / „ > 

l(reg) } 


return data: register 1 5 is set to 

code meaning 

04 system limit reached; no more 

interruptions may be set up 
08 time specified is not in the future 
OC normal return 


[symboll 


SETTOD 


none (preload regs & 1 with time of day) 


[symbol] 


SETTR 


none (preload regs & 1 with time limit) 


return data: 

reg 15 = X'10' if system limit for real-time 

interrupts is reached 


[symbol] 


SETTU 


f *■ (value) 

L time {(i)}_ 




[symbol] 


SETUP 


field|^},contentregister{ odd ; v i a ) 3ue } 




register 

notation implied 
code value length definition 
USERID 1 8 set user ID field 
SYSIN 3 2 set input data set 

location 
SYSOUT 4 2 set output data set 

location 
BSN 5 1 set batch sequence 

number 
CONV 10 1 set conversational 

task flag 
ITMFLG 12 1 set intertask message 

nag 

XPR 3 3 2 set external priority 
flag 

AUTH 14 1 set privilege 

STE 15 1 set schedule table 
entry field 

MAV 16 2 set maximum auxil- 
iary storage field 


[symbol] 


SETXP 


none 


[symbol] 


SETXTS 


field <EST1M > 


[symbol] 


SETYMD 


none (preload regs and 1 with year, month 
and day) 
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Name 


Operation 


Operands 


[symbol] 


SPATH 


/ /POF-set units partitioned \\~ 
/ 1 flag off (0) ) 1 
1 ] PON-set units partitioned { I 
jcode/ flag on (1) > f 
flag/ /SOF-set units malfunction I \ 
J [ flag off (1) ]/ 
/ \SON-set units malfunction / V 
( ' flag on (1) 1 








J component-code, device address-hexinteger) 
J (1) i] 






component codes: 






1 - I/O device only 






2 - control unit only 






3 - control unit and I/O device 






4 - channel unit only 






5 - channel and I/O device 






6 - channel and control unit 






7 - channel, control unit, and I/O device 


[symbol] 


STORE 


area-addrx,(regl-integer[,reg2-integcr]) 


[symbol] 


SYSER 


errtypc-integer,dump-integer,optl-mteger, 
opt2-integer,opt3-integer,idno-integer 





TAM (terminal 


access method) 


[symbol] 


CHECK 


, , | addrx ) 


[symbol] 


CLOSE 


(dcb-addr....) 
[M.|( E ,, Sl -{- r })|] 


[symbol] 


DCB 


[DDNAME=symbol] [,DSORG=CX] 

,MACRF=!(W) [ [,BUFNO=abscxp] 
L ?(R,W)' J 


[symbol] 


DDEF 


[,BUFL=ubsexp] [,BFTEK=D] 
[,EXLST=relexp] [,SYNAD=relexp] 
ddname-symbol,DSORG=CX, 
DSNAME=data set name, UNlT=sda 
Note: For additional optional parameters, see 

(jUKk Gil Ilk loi Lj^ 


[symbol] 

I symbol] 


DFTRMENT 
OPEN 


[DIAL=(integer,...)] 
[,ADRID=(adrid-charaeters,...)] 
[,POLLID=(pollid-characters,...j] 
( | dcb-addr, j ) 

HH a n, r l)j] 


[symbol] 


READ 


decb j^™^ \ typc-codcdcb-addr, 

H1 dr H ,h {TI 

[argl-addr] ,[arg2-code] ,MF= j H 


[symbol] 


WRITE 


decb / t, type-code, dcb-addr, 
[area-addr] .length-value, 
[argl-addr] ,[arg2-code] ,MF= jH 
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Name 


Operation 


Operands 


[symbol] 


TSEND 


none 


[symbol] 


TWA IT 


none 


[symbol] 


UPDTUSER 


none 


[symbol] 


USAGE 


area-addr [,userid-addr] 


[symbol] 


VSEND 


none 


return data: 

reg 15 = code definition 

00 recipient task cannot be found 
04 message not acceptable 
08 message sent 


I symbol] 


VSENDR 


msg-text,reply-addr,reply-length, 

message code-value, sending taskid-addr 


symbol 


WAIT 


f . (A-muItitermenal Vl 
environment I . „ cc H 
L \T-standard TSS JJ 


note: when standard TSS environment specified, 
register must be set with a pointer to the system 
TCT slot for that task 




WRITE 


(see TAM) 


[symbol] 


WRITEQ 


relative line number-value 
,area-addr, lengtb-value 

[lNTRPT-{£}] [BREAK-{J}] 

LcOMPOUT=value |, TRNSOUT = \1\\ 
[ RESP= i ^ U 1 COMPIN=value 
f". TRNSIN={ !J jj 


return data: 

code meaning 

00~ normal return 

04 invalid relative line number 

08 busy 

0C attention interruption received 

from terminal 
10 solid error during start-I/O 
14 message length exceeds 4080 bytes 
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Name 


Operation 


Operands 


I symbol] 


XTRCT 


>S] 


register 

notation implied 
code value length definition 
USERID 1 8 extract user ID field 
PRIORITY 2 1 extract priority fid 
SYS1N 3 2 extract sysin symbolic 

dev addr 
SYSOUT 4 2 extract sysout sym 

dev addr 
BSN 5 I extract batch sequence 

number 
SOPRIV 6 1 operator privilege 
SPPRIVF 7 1 system programmer, 

nonprivileged 
SRP1V 8 1 system programmer, 

privileged 
UPRIV 9 I user privilege 
CONV 10 1 conversational task flag 
TASKID 11 2 task ID field 
XPR 12 1 external priority flag 
1TMFLG 13 2 intertask message flag 
AUTH 14 1 extract privilege field 
PEND10 15 I pending I/O operations 

count field 
MAV 16 2 auxiliary storage 

requirement field 
DISK 17 2 auxiliary storage count 

field 
return data: regsO and l=extracted TSI field; 
right justified; number of bytes equals implied 
length 




XTRSYS 


Hr L "|i 




register 

notation implied 
code value length definition 


TOD 1 8 get time of day 
YMD 2 8 get year ,month,days 
TASKINIT 3 1 get task initiation status 
AVAUX 5 4 get available auxiliary 

count field 
return data: regsO and l=extracted TSI field; 
right justified; number of bytes equals implied 
length 


[symbol] 


XTRTM 


none 

return data: reg l=lotal accumulated task CPU time 
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Name 


Operation 


Operands 


[symbol] 


XTRXTS 




>{u"L 




register 








notatior 


implied 






code value 


length definition 






UTIMF, 1 


4 user-time field 






ATIME 2 


4 accumulated-time Held 






ESTIM 3 


4 estimated run-time 
field 






TWA1T 4 


2 number of TWAJT 

field 






AWAIT 5 


4 number of AWAIT 
field 






TSLICE 6 


4 number of time slices- 
field 






AUX-IN 7 


4 number of page -ins 
from aux storage 






RXT-1N H 


4 number of page-ins 
from external storage 






AUX-OUT <i 


4 number of page-outs 
to aux storage 






HXT-OUT 1 


4 number of page-outs 
to external storage 






MDISK 1 1 


2 maximum pages used on 
aux disk field 


return data: regs 


and 1 = extracted field from 






XTSI; right justifie 


i, padded 0"s; number ot 






bytes = implied len 


?th 


| symbol] 


ZEROSST 


none 



INNER MACRO INSTRUCTIONS 





CHDERMAC 


mesno-integcrT opnm-charaeters] , 
[opva-characters] ,[opvb-characters] , 
[opvc-characters] [,S=intcger] 


symbol 


CHDINNRA 


, i addrx / , r , i addrx i , 
[paraone-j (]) j ] Jparazero] j (Q) [] 

l([sublista-j symbo1 ( ] [.sublistb-integer])], 
1 integer » 

[entrcd-absexp,] [mcrcd-code] 


[symbol] 


CHDPSECT 


[loe-addr],[ align- 1 |j {, string-text] 
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SYSTEM ENTER CODE TABLE 



Decimal 


Hex 


Name 


Entry point 


PSECT 






TAM 






U 


00 


READ/WRITE 


CZCYMI 


CZCYMP 


1 


i 


BATCH MONITOR 


CZABAF 


CZABAF 






INTERRUPT HANDLING 






16 


10 


SIR 


CZCJSA 


CZCJSP 


17 


1 1 


DIR 


CZCJDA 


CZCJDP 


18 


12 


1NTINQ 


CZCJIA 


CZCJIP 


19 


13 


STIMER/TTIMER 


CZCJA1 


SYSJAR 


30 


IE 


Tost Case 1 


TEST1V 


TEST1R 


31 


IF 


Test Case 2 


TEST2V 


TEST2R 






SAM 






32 


20 


READ/WRITE 


CZCRAS 


CZCRAP 


33 


21 


CHECK 


CZCRCS 


CZCRCP 


34 


22 


CNTRL 


CZCRBS 


CZCRBP 


36 


24 


POINT 


CZCRMA 


CZCRMP 


37 


25 


BSP 


(ZCRGA 


CZCRGP 






VM ALLOCATION 






48 


30 


GETMA1N (R) 


CZCH2 


CZCH5 


49 


31 


GETMAIN (PAGE) 


CZCG2 


CZCG5 


SO 


32 


FREEMAFN (R) 


CZCH3 


CZCH5 


51 


33 


FREEMA1N (PAGE) 


CZCG3 


CZCG5 






VAM GENERAL SERVICES 






56 


38 


VDMFP 


CZCQK i 


CZCAKP 


57 


39 


DUPOPEN 


CZCQK1 


CZCQKP 


58 


3A 


DUPCLOSE 


CZCEY1 


CZCFYP 






VISAM 






61 


3D 


VISAM SETL 


CZCPC3 


CZCPC3 


62 


3E 


VAM 
VSAM PUT 


CZCOS3 


CZCOS3 


63 


3F 


IJBESRCH 


CZCDL3 


CZCDLP 


64 


40 


READ/WRITE 


CZCPE1 


CZCPEP 


65 


41 


ESETL 


CZCPD1 


CZCPIP 


66 


42 


RELEX 


CZCPG1 


CZCPIP 


67 


43 


DELREC 


CZCPH1 


CZCPEP 


68 


44 


FIND 


CZCOJ 1 


CZCOJP 


69 


45 


STOW 


CZCOK1 


CZCOKP 


70 


46 


ADE 


CZCPL1 


CZCPLP 


71 


47 


GETPAGE 


CZCPI1 


CZCPIP 


72 


48 


1NSPACE 


CZCOD1 


CZCODP 


73 


49 


DELPAGE 


CZCOD2 


CZCODP 


74 


4A 


VSAM PUT EXTERNAL USER 


CZCOS 1 


CZCOSP 


75 


4B 


VSAM PUT INTERNAL 


CZCOS2 


CZCOSP 


76 


4C 


MOVEPAGE 


CZCOC1 


CZCOCP 


77 


4D 


FLUSHBUF 


CZCOV 1 


CZCOVP 


78 


4E 


VISAM GET PAGE INPUT 


CZCPI2 


CZCPIP 


79 


4F 


VISAM GET PAGE OUTPUT 


CZCP13 


CZCPIP 






MACRO COMMAND LANGUAGE 






80 


50 


GATRD/GATWR 


CZATC2 


CZATCP 


81 


51 


WTO 


CZABQ1 


CZABQR 


82 


52 


WTOR 


CZABQI 


CZABQR 


83 


53 


ERASE 


CZAEJ7 


CZAEJR 


84 


54 


DATADEF 


CZAEA3 


CZAEAR 


85 


55 


DEC ALL 


CZAFS2 


CZAFSR 


86 


56 


ABEND 


CZACPI 


CZACPR 


87 


57 


CARD 


CZABD7 


CZABDR 


88 


58 


TAPE 


CZABD9 


CZABDR 


89 


59 


LIST 


CZABD3 


CZABDR 


90 


5A 


CATALOG 


CZAEI2 


CZAEIR 


91 


5B 


UNCATLG 


CZAEJ5 


CZAEJR 


92 


5C 


DSCOPY 


CZAFV2 


CZAFVR 


93 


5D 


TEMP DATADEF 


CZAEA5 


CZAEAR 


94 


5E 


WTL 


CZABQI 


CZABQR 


95 


5F 


USATT 


CZASA6 


CZASAP 


96 


60 


F1NDJFCB 


CZAEB1 


CZAEBR 


97 


6! 


CLATT 


CZASA7 


CZASAP 


98 


62 


RELEASE 


CZAFJ2 


CZAEJR 


99 


63 


USAGE 


CZAGB 1 


CZAGBP 
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100 


64 


FINDDS 


CZAEC1 


CZAECR 


101 


65 


MSGWR 


CZAAD3 


CZAADR 


102 


66 


UPDTUSER 


CZAGC2 


CZAGCR 






GENERAL SERVICES 






112 


70 


10REQ 


CZCSBI 


CZCSBR 


113 


71 


MSAM READ/WRITE 


CZCMF1 


CZCMFP 


114 


72 


MSAM - SET UNIT RECORD 


CZCMD1 


CZCMDP 


115 


73 


MSAM FINISH 


CZCMH1 


CZCMHP 


128 


80 


OLTAM DEV. ALLOC. 


CZATG1 


CZATGP 


129 


81 


OLTAM - EX. I/O 


CZATA1 


CZATAP 


130 


82 


OLTAM - POSTING 


CZATB1 


CZATBP 


131 


83 


OLTAM - TEST COMMAND 


CZATS1 


CZATSP 


144 


90 


OPEN 


CZCLAO 


CZCLAB 


145 


91 


CLOSE 


CZCLBC 


CZCLBP 


146 


92 


FEOV 


CZCLDF 


CZCLDB 


147 


93 


RFR 


CZASD3 


CZASDP 


148 


94 


GDV 


CZASDX 


CZASDP 


149 


95 


AETD 


CZASB5 


CZASBP 


150 


96 


OBEY 


CZASA4 


CZASAP 


151 


97 


MCAST 


CZATUI 


CZATUP 


152 


98 


SYS IN 


CZASC7 


CZASCP 


153 


99 


LPCINIT 


CZASW1 


CZAMZP 


154 


9A 


LPCED1T 


CZASW4 


CZAMZP 


155 


9B 


PRMPT 


CZATJ 1 


CZATJP 


156 


9C 


ATTN 


CZASB2 


CZASBP 


157 


9D 


GATE 


CZATC2 


CZATCP 


158 


9E 


ENTRFR 


CZASD5 


CZASDP 


159 


9F 


DELENT 


CZASD6 


CZASDP 


160 


A0 


CSTORE 


CZCKZ1 


CZCKZP 


161 


Al 


NXTRFR 


CZASD4 


CZASDP 


162 


A2 


DICTIONARY HANDLER 


CZASD2 


CZASDP 


2si (reserved for TSS/360 users) 



SVCs ISSUED BY MACRO INSTRUCTIONS 

Meaning 

normal program end 

restore and enable interrupts 

read command from SYSIN (unconditional) 

read command from SYSIN (conditional) 

restore privilege 

enter privileged service routine 

enter command language director to end run 

enter delete program 

enter program checkout subsystem 

transfer to dynamic loader for external symbol 

resolution 

sample system statistics 

zero system statistics table 

attach a task to the system 

reset drum interlock 

indicate line code for a terminal 

check for terminal MTT status 

wait for terminal stimuli 

special create task status index 

connect a multiterminal task to the system 

disconnect a multiterminal task from the system 



SVC 


Macro 


Code 


Name 


116 


EXIT 


117 


RAE 


118 


CLIP 


119 


CLIC 


120 


RSPRV 


121 


ENTER 


122 


RTRN 


123 


DELET 


125 


PCSVC 


127 


DLINK 


193 


SAMPLE 


194 


ZEROSST 


195 


ATTACH 


201 


RDI 


202 


LCD 


203 


CKALOC 


204 


WAIT 


206 


SCRTSI 


207 


CONN 


208 


DCON 
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SVC 


Macro 


Code 


Name 


209 


XTRTM 


210 


SETAE 


211 


SPATII 


212 


RSTTIM 


213 


XTRXTS 


214 


SETXTS 


215 


XTRSYS 


216 


SETSYS 


216 


ALLTI 


216 


SETYMD 


216 


SETTOD 


217 


SETTR 


218 


REDTIM 


219 


ATCS 


221 


RESET 


222 


PURGE 


225 


PRESENT 


226 


PULSE 


227 


CHANGE 


228 


SYSER 


229 


TWA IT 


231 


IOCAL 


232 


RJELC 


233 


RMDEV 


234 


ADDEV 


235 


SETUP 


236 


ADSPG 


237 


DSSEG 


238 


CNSEG 


239 


XSEND 


240 


VSEND 


241 


CKCLS 


242 


PGOUT 


243 


TSEND 


244 


SETXP 


245 


MOVXP 


246 


XTRCT 


247 


LSCHP 


248 


AWAIT 


249 


DELPG 


250 


ADDPG 


251 


SETTU 


252 


DLTSI 


253 


CRTSI 


254 


ERROR 


254 


LVPSW 



Meaning 

extract accumulated CPU time 

set asynchronous entry 

set I/O device path 

reset system time 

extract extended task status index field 

set up extended task status index field 

extract system table field 

set system table field 

allow task initiation 

set year, month, and day 

set time of day 

set real time interval 

real elapsed real time 

activate terminal communication subprocessor 

reset device-suppression flag 

purge I/O operations 

present current schedule level 

pulse schedule table entry level 

change schedule table entry 

indicate nonresident-program detected error 

wait for terminal I/O interrupt 

I/O call 

remote job entry line control 

remove device from task 

add device to task 

set up task status index field 

add shared virtual storage pages 

disconnect shared page table from segment 

connect segment to shared page table 

send message to another task 

send message to another task 

check protection class 

write virtual storage pages on external storage 

forced time-slice-end 

set external page table entries 

move page table entries 

extract task status index field 

list changed virtual storage pages 

wait for interrupt 

delete virtual storage pages 

add virtual storage pages 

set user timer 

delete task status index 

create task status index 

indicate supervisor-detected error 

load virtual program status word 



30 



CONTENTS 

DCB . . . 33 
DECB ... 34 
GQE ... 34 

GQE flags ... 35 
Interrupt log 

Resident Supervisor ... 35 

Task Monitor ... 36 
IORCB ... 36 
ISA . . . 37 
MCB ... 37 
Page table ... 38 

Externa] page table ... 38 

Resident shared page table ... 3 
PCB ... 38 
PSA . . . 39 
Sense bytes ... 39 
Segment table ... 4 1 

Auxiliary segment table ... 41 
SYSTAB...41 
TSI . . . 41 
XTS1 ... 42 



31 



CONTROL BLOCKS 



Data Control Block (DCB) 



CHADCB 




Hex 


Symbol 


Meaning 


0~ 


DCBDSO 


data set organization 


2 


DCBMAC 




4 


DCBEXL 


user exit list pointer 


8 


DCBDDN 


ddname 


10 


DCBSYV 


synad address (VCON) 


14 


DCBSYR 


synad address (RCON) 


18 


DCBEOV 


EODAD address (VCON) 


1C 


DCBEOR 


EODAD address (RCON) 


20 


DCBBUF 


buffer length 


22 


DCBEV 


device type 


23 


DCBBUN 


number of buffers 


24 


DCBBCN 


buffer control 


28 


DCBBFT 


buffer technique 


29 


DCBNCP 


number of channel programs 


2A 


DCBREC 


record format 


2B 


DCBOPT 


open processing option 


2C 


DCBLRE 


record length 


30 


DCBBLK 


blocksize 


32 


DCBBD1 


device dependent parameters 1 


32 


DCBKEY 


keylength 


32 


DCBPRT 


printer space 


32 


DCBSTA 


stacker select 


32 


DCBCOD 




33 


DCBDD2 


device dependent parameters 2 


33 


DCBMOD 


mode - reader/punch 


33 


DCBTRT 


tape recording technique 


34 


DCBERO 


error options 


35 


DCBPAD 


padding 


36 


DCBRKP 


relative key position 


38 


DCBLPA 


VAM, retrieval address 


38 


DCBLPDA 




3C 


DCBLPN 


logical record count in block 


3E 


DCBOPI 


options 


3F 


DCBOFG 


open flags 


40 


DCBMSK 


DCB mask flag 


44 


DCBID 


DCB identifier (*%*%) 


48 


DCBCON 


SAM, pointer to next JFCB in con- 
catenated data set TAM, pointer to 
work area 


4C 


DCBDEB 


SAM or TAM, pointer to DEB 
VAM, pointer to RESTABL 


50 


DCBLEN 


DCB length 


51 


DCBIFL 


IO flags 


52 


DCBMCD 


macro code 


54 


DCBIMK 




58 


DCBGTV 


GET (VCON) 


5C 


DCBGTR 


GET (RCON) 


60 


DCBPTV 


PUT (VCON) 


64 


DCBPTR 


PUT (RCON) 


68 


DCBPXV 


PUTX (VCON) 


6C 


DCBPXR 


PUTX (RCON) 


70 


DCBSLV 


SETL (VCON) 


7C 


DCBSLR 


SETL(RCON) 


78 


Access method dependent portion begins 






78 - C7 - BSAM and QSAM 120 199 






78-B7 -VAM 120-183 






78-A7-IOREQ 120-167 






78 -C7 -MSAM 120-199 






78 -C4 -TAM 120-195 



Macro 
Operand 

DSORG 

MACRF 

EXLST 

DDNAME 

SYNAD 

EODAD 

BUFL 

DEVD 

BUFNO 

BUFCB 

BUFTEK 

NCP 

RECFM 

OPTCD 

LRECL 

BLKS1ZE 

KEYLEN 

PRTSP 

STACK 



MODE 

TRTCH 

EROPT 

PAD 

RKP 



1FLGS 
IMSK 
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Data Event Control Block (DECB) 



Hex 


Symbol 


Meaning 


0~ 


DECECB 


event control block 




DECECM 


completion flag 


1 


DECBSF 


BSAM flags 


2 


DECSVC 


AWAIT supervisor call 


4 


DECTYP 


operation type code 


6 


DECLEN 


data area length 


8 


DECDCB 


address of DCB 


C 


DECDAD 


data area address 


10 


DECSAD 


address of status indicators 


14 


DECKAD 


address of VIS key 


14 


DECTAD 


address of TAM terminal entry list 


14 


DECVCA 


VCCW list address 


19 


DECSTA 


status 


1A 


DECSBO 


sense byte 


IB 


DECSB1 


sense byte 1 


1C 


DECRES 


TAM - response 


1C 


DECVCL 


VCCW list-double word length 


ID 


DECCSC 


TAM character set code 


ID 


DECVCS 


number of double words to start CCW from 
VCCW origin 


IE 


DECFL1 


flags Bits 

7 

6 

5 active 

4 user error 

3 input area overflow 

2 buffer overflow 

1 system error 

intervention request 


IF 


DECFL2 


flag Bits 

7 abend request 

6 

5 request synad 










4 in use 






3 write 






2 read 






1 response 






attention 


20 


DECCSW 


channel status word 


28 


DECASB 


sense bytes 0—7 



General Queue Entry (GQE) 



CHAGQE 




Hex 


Symbol 


Meaning 


00 


GQEFWD 


forward link 


04 


GQETSI 


TSI pointer 


08 


GQESVC 


SVC-IORCB-MCB pointer 


OC 


GQESAT 


set address table pointer 


10 


GQERR 


I/O error count 


11 


GQEF0 


flag 


12 


GQEF5 


flag 


13 


GQEF4 


flag 


14 


GQEPCB 


PCB pointer 


18 


GQECNT 


PCB count 


19 


GQEF1 


flag 


1A 


GQEF2 


flag 


IB 


GQEF3 


flag 


1C 


GQEQPS 


queue processor strings 


24 


GQESPT 


SPT pointer 
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28 GQESNS sense data 

30 GQECSW CSW 

38 GQEDEV symbolic device 

3A GQEINT interrupt code 

3C GQEREV reverse link 

GQE Flags 

1 1 GQEFO 80 - control unit end 

40 - sense data present 

20 - 2nd TSEND pg scan requir 

10 - paging interrupt 

08 - I/O purged 

04 - ignore device end 

02 - skip I/O request 

01 - PCB reposting 
19 GQE FT 80 -paging in 

40 - paging out 

20 - VAM or system paging 

10 - waiting on sense 

08 — seek argument table setup 

04 — VAM read-after-write check flag 

02 - 0=DIRECT SVC; 1=EXECUTE SVC 
01 - IORCB associated with GQE 

1A GQEF2 80 - IORCB sense op pending 

40 - path 
20 - core block 
10 — I/O paging in 
08 - I/O 
06 - CPU number 

01 - forced TSE 

IB GQEF3 80 - shared page table 

40 - queue error 
20 — master flag 
10 - TWAIT 
08 - ASAOP process flag 
04 - path error 

02 -~ halt I/O 

01 - awaiting device end 

13 GQEF4 80 - DRAM IORCB posting req 

40 - CEASS waiting on busy pointer 

20 - shared page migration 

10 - shared page posting 

08 - pointer to GQELOG or GQE1GQ is present 

04 - reactivate interruption 

02 — partially processed 

01 - TWAIT pageout in progress 

12 GQEF5 80 - data recording 

40 — data recording restart 
20 - end of tape request 
08 -end or file 
04 - rewind/unload 

Interrupt Log 

RESSUP 

CEAJ1L 

00 



CPUID 

CPU1=80 
CPU2=40 
CPU 3=20 
CPU4=10 
interruption type 
18 - external 
20 - SVC 
28 - program 
30 - machine check 
38 - I/O 
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02 
04 



interrupt code or symbolic device address 
interruption pointer 

a) for TSS I/O interruption is 
supervisor state, byte 4=bytc 
in extended PSW, bytes 5-7= 
instruction address 

b) forRSS program and I/O 
interruptions, pointer to 
TSSLOG where interrupt is 
logged 

e) for all other interruptions, 
address of TSI at time of 





interruption 


08 


old PSW or CSW 


Interrupt Log 


1 


TM 




CZCJTL 




03 


1 - program 




02 - SVC 




03 — external 




04 - asynchronous I/O 




05 - timer 




06 — synchronous I/O 


04 


old VPSW 



Input/Output Request Control Block (IORCB) 



SVC for IOCAL 

CSW channel status byte 
IORCB flag byte 80 - IORCE flag 
40 - IOROB flag 
length of IORCB in 64 byte units 
length of page list in doublewords 
relative origin of page list 
protection key 
SIO failure count 
length of CCW in doublewords 
relative origin of CCW list in doublewords 
relative origin of starting CCW 
length of IORCB data buffer 
relative origin of data buffer in doublewords 
actual I/O address (2 bytes) 
system symbolic device address 
pointer to DEB 
pointer to DECB 

pointer to posting routine (VCON) 
pointer to posting routine (RCON) 
device type codes 

pointer to IORCB virtual storage buffer 

data buffer address 

sense bytes 0-7 

condition codes from sense 

sense status field 

sense failure flags 

HIO retry count 

alternate path retry count 

flag bytes 

X'80' specific path mask 

X'40' ignore sick indicator 



CHAIOR 





IORSV 


2 


IORCSB 


3 


IORF3 


8 


IORLN 


9 


IORGL 


A 


IORPO 


B 


IORKY 


C 


IORSF 


D 


IORCL 


E 


IORCS 


1 


IORST 


10 


IORBL 


11 


IORBS 


12 


IORAP 


16 


IORSD 


18 


IORDE 


1C 


IORDC 


20 


IORPV 


24 


IORPR 


28 


IORDT 




or 


28 


lORVB 


2C 


IORBA 


30 


IORSNS 


38 


IORSN 


39 


IORSU 


3B 


IORSL 


3C 


IORHF 


43 


IORHE 


44 


IORFL 




IORF1 



36 



48 
49 
4C 
4E 



IORSA 
IORSE 
IORSG 
IORSH 



X'20' reissue SIO mask 

X'10' software command chain mask 

Xt^' error retry 

X'04' issue HJO mask 

X'02' on unit check read RO 

X'01' alternate track flag 

X'80' PCI equal channel/device end mask 

X'40' no path exists 

X'20' CCW specification error 

X'10' SIO failed mask 

X*08' HIO failed mask 

X'04' read RO failed 

X'02' sense failed mask 

X'01' CCWs are relocated mask 

X'40' save retry count 

X'20' reset device mask 

X'10' reset suppress flag Fl 

XDS' interrupt code stored mask 

X'04' IORCB chaining mask 

X'02' queue channel interrupt mask 

X'01' drum request access method mask 

X'80' incorrect length error mask 

X'40' had external machine check error mask 

X'20' multiple I/O return mask 

X'10' force CE/DE/PCI on first SCC 

X'08' force DE on first SCC 

sense operation code 

sense address 

sense flags 

sense count 



Interrupt Storage Area (ISA) 

CHAISA 

6B8 ISASSA short save area (length, 10F) 

6E0 ISALS1 long save area (nonpriv)(length,3GF) 

6E0 length of save area 
6E4 GPR 13 save area 
6E8 save area of called pgm 
6EC GPR 14-12 



730 


ISAIOP 


old PSW 






758 




privileged long save area 


(length, 


3 OF) 


7D0 


ISAOP 


old task PSWs (length, 6D) 




800 


1SANP 


new task VPSWs (length, 6D) 










Old 


New 






program 


7D0 


800 






SVC 


7D8 


808 






EXT. 


7E0 


810 






asynchr. I/O 


7E8 


818 






timer 


7F0 


820 






synchr. I/O 


7F8 


828 


850 


ISATDT 


TDT origin 






860 


ISACVP 


current VPS W (length, D) 




868 


ISATDY 


TDY pointer 






87C 


ISATMP 


ptr to TM PSECT 






880 


ISARCB 


IORCB or MCB (length. 


24 0D) 





Message Control Block (MCB) 

CHAMCB 

message length in double words 
flag byte X'80' reply expected 
X'40" reply mask 

2 MCBRCD return code for MEB 

3 MCBCD1 MCB message code 

4 MCBSVC VSEND SVC 



MCBLNG 
MCBCOD 
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6 


MCBSPR 


spare space 


8 


MCBSND 


task ID of sending task 


A 


MCBRCV 


task ID of receiving task 


C 


MCBECB 


address of event control block 


10 


MCBTXT 


message text 



Page Table 

CHAPGT 

00 PGTCBA core block address 

01 bit 4 - availability 

External Page Table 



00 XPTXL ex t. location of page 

04 XPTF1 80 - update in place 

40 - prefer paging device drum 

20 - type program or data 

10 - changed paged bit 

08 - TWAIT complete 

04 - pages assigned 

02 - shared pages 

01 - page processed by LDR 

05 XPTF2 80 - temporary external address 

20 - shared XPT entry 
10 - auxiliary storage 
OF — 4-bit protection class 

06 XPTPMC page preference 

counter 

07 XPTPH FO-page hold count field 

Resident Shared Page Index (RSPI) 

CHARSP 

shared page tbl length 
SPT origin 

shared page tabic 

lock byte for shared page table 

Hag byte 

GQE chain 

in-use page count 

unused-page count 

number of bytes assigned this SPT 



00 


RSPPTL 


01 


RSPPTO 


04 


RSPSF1 


06 


RSPLOCK 


07 


RSPFL1 


08 


RSPGQE 


OC 


RSPN 


0D 


RSPU 


OH 


RSPLNG 



Page Control Block (PCB) 

CHAPCB 



00 


PCB I A 


internal address of page 


04 


PCBXA 


auxiliary /external address of page 


08 


PCBVA 


VM address of page 


OC 


PCBF1 


flag 


0D 


PCBF2 


flag 


0E 


PCBF3 


flag 


OF 


PCBF4 


flag 


10 


PCBER 


TWAIT migration XPT ptr SA 


14 


PCBE2 


PCB entry 2 


28 


PCBE3 


PCB entry 3 


3C 


PCBCA 


PCB chain address 


CHAPCB flags 




OC 


PCBF1 


E0 - VAM pageout sequence no. 

10 - bypass 

0C - VM or XTSI page 

02 - null 

01 - page I/O complete 


0D 


PCBF2 


80 - write check complete 
40 - read/write 
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OF PCBF4 



20 - device preference 

10 - user core release 

08 - XTSI or PSW page 

04 - preference for auxiliary disk 

02 - VM page 

01 - XTSI page 

00- type 1 1st XTSI page 
40 - type 2 FTP 

80 - type 3 auxiliary segment page 
CO - type 4 segment table page 
20 - TWAIT paging operation 
10- IOCAL paging operation 
08 — relocation paging operation 
04 - pageout paging operation 

02 - dispatcher paging operation 

1 - monitor sharing page operation 

80 - TSEND paging operation 

40 - suppress posting page operation 

20 - paging request by VAM 

10 - page posting read 

08 - suppress allocation 



Prefix Storage Area (PSA) 



CHAPSA 




0E 


PSAEIC 


external interruption code 


10 


PSASIC 


SVC 


12 


PSAPIC 


program 


14 


PSAMIC 


machine check 


16 


PSAIIC 


I/O 


18 


PSAEOP 


old PSW area 


40 


PSACSW 


CSW 


48 


PSACAW 


CAW 


58 


PSAENP 


new PSW area 


80 


PSACLO 


logout area 


130 


PSAILO 


channel logout area 


148 


PSAISS 


interrupt stacker save area 


168 


PSACAS 


core allocation save area 


188 


PSATPT 


TSI pointer 


18C 


PSAQPT 


GQE pointer 


190 


PSADPT 


DCB pointer 


198 


PSATPW 


PSW used by dispatcher 


1B8 


PSA DAT 


drop area 


228 


PSARN 


recovery nucleus residing 


COO 
BYT 


PSASER 
SO 


SERR bootstrap residing 
SENSE BYTES 



\ Bit 


















De\ 

vice \ 
Type \ 







2 


3 


4 


5 


6 


7 


1052, 


Cmd 


Jnt 


Bus 


Eq 


\/ 








2150 


rej 


req 


out 


chk 


/\ 








2540/ 


Cmd 


Int 


Bus 


Eq 


Data 




Unusual 




1821 


rej 


req 


out 


chk 


chk 




cmd 




1403 


Cmd 


Int 


Bus 


Eq 








Ch 


1443 


rej 


req 


out 


chk 


/Type 
/ bar 


/Type 




9 


2400 


Cmd 


Int 


Bus 


Eq 


Data 


Over- 


Write- 


Data 




rej 


req 


out 


chk 


chk 


run 





Chk 



(Continued) 
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2311/ 


Cmd 


Int 


Bus 


Eq 


Data 


Over- 


Track- 


Seek 


284! 


rej 


req 


out 


chk 


chk 


run 


ehel 


chk 


2301/ 


Cmd 


Int 


Bus 


Eq 


Data 


Qver- 


V 




2820 


rej 


req 


out 


chk 


chk 




/\ 


addr 



2400 


Noise 


00-Non-Xst Tu 


7 


AT 


Wrt 


File 


Tape 






01 -Not ready 


trk 


load 


status 


protect 


ind 






lO-Rdy&norwd 




point 












ll-Rdy&rwdng 












2311/ 


Data 


Trk 


End 


Invalid 


No 


File 


Missing 


Over- 


2841 


chk 


over- 


of 


seq 


rec 


prot 


addr 


flow 




fid 


run 


ctl 




found 




mrkr 


inl 


2301/ 


Data 


Trk 


End 


Inval 


No 


File 


Service 


Over- 


2820 


chk in 


over- 


of 
cyl. 


seq 


found 


prot 


over- 


inl 



2400 


BitsO 


- 7 indies 


te track ir 


error 






6 & 7 indicate 
no error or 
multi-error 


2311/ 


Un- 


\/ 


Serial- 


Tag 


Alu 


Unsel 






2841 


safe 


/\ 


izer 
chk 


chk 


chk 


status 






2301/ 


Un- 


Shift 


Skew 


Ctr 


Comp 




\/ 


V 


2820 


safe 


reg 


fail 


chk 


chk 




/\ 


/\ 



2400 


R/W 
vrc 


Lrer 


Skew 


Crc 


Skew 
req 




Bkwd 

status 


pare 


2311/ 


Ready 


On 


Read 


Write 


On 


End 




Seek 


2841 




line 


safety 


safety 


line 


of 
cyl 




incmpl 


2301/ 


Lrc 


Lrc 


Lrc 


Lrc 










2820 


bitO 


bit 1 


bit 2 


bit 3 











2400 


Echo 


Res 


Read 


Write 


Delay 


Seq 


Seq 


Seq 




err 


tape 


clock 


clock 


counter 


ind 


ind 


ind 






unit 


err 


err 


err 


C 


B 


A 


2301/ 


Seq 


Seq 


Seq 


Seq 


Seq 


Seq 


Seq 


Seq 


2820 


ind 


ind 


ind 


ind 


ind 


ind 


ind 


ind 







1 


2 


3 


4 


5 


6 


7 
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2311/ 
2841 



2301/ 
2820 



Command in progress when overflow incomplete occurs. 



Command in progress when 
Write = X'05' or 

Read = X'06' Zero 



Segment Table 

CHASGT (length,! 7 ) 

00 SGTPTL page table length 

01 SGTPTO page table origin 

bit 31 - availability 

Aux Segment Table 

CHAAST (length, D) 



00 


ASTDA 


04 


ASTN 


05 


ASTU 


06 


ASTM 


07 


ASTF 



page table location 

in use page count 

unused-page count 

max. allowed pages 

80 - variable length segment 

40 - page table in next XTS1 page 

20 — page table in core 

10 — shared segment 

01 - segment assigned 



System Table (SYSTAB) 

CHASYS 



00 


SYSPEC 


04 


SYS LOW 


06 


SYSH1 


08 


SYSFL1 


OC 


SYSRSP 


28 


SYSPSW 


30 


SYSTOD 


38 


SYSYMD 


40 


SYSFIT 


44 


SYSLIT 


48 


SYSLT 


CO 


SYSRSV 


C4 


SYSRSC 


1D0 


SYSPF 


1D4 


SYSDIP 


1018 


SYSCSW 


1028 


SYSSDA 


10E8 


SYSPCIR 


10EC SYSGQER 



pointer to start dispatchable and active list 

low core threshhold (low) 

low core threshhold (high) 

flags 

RSP1 pointer 

low core PSW save area 

time of day clock 

day-month-year in serial days 

pointer to first inactive TS1 

pointer to last inactive TSI 

pointer to end of active list 

pointer to supervisor's reserve core list 

count of pages in reserve list 

last PDD entry flag 

pointer to drum interface control block 

old channel CSW 

sense data area 

PCB/IORCB address 

GQE address 



Task Status Index (TSI) 

CHAT SI 



00 


TSIFPT 


forward pointer to next TSI 


04 


TSINX 


number of XTSI pages 


06 


TSIPMF 


pending and mask flags 


08 


TS1XXL 


external location 1st XTSI page 


OC 


TSILOC 


internal location 1 st XTSI page 


10 


TSIUID 


userid 


18 


TSIS1N 


SYSIN 


1A 


TS1SOT 


SYSOUT 


1C 


TSITDP 


task device list pointer 


(Continued) 
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20 TSIRPOST pointer to page reposting GQE 

24 TSITSN TSE GQE pointer to 2nd scan 

28 TSITIC task interrupt count 

30 TSITIP pointers task interrupt queue entries 

5E TSICiO I/O requests pending count 

5F TSICP paging requests pending count 

60 TSILOCK lock byte 

61 TSIFLG 10-delay 02 -in execution 

08— ready 01 -page wait 

04 -TSE 

62 TSIF2 80-in the wall 

40 TWAIT 

20 -terminal I/O 

08 -inactive task 

04 -conversational 

02-XTSI out 

01 -current ring end 

63 TSIF3 80 -quantum 

40-PR1 
20-I/O paging 
10-ITI/PTI reset 
08-end of time slice 
04 -real time slice end 
02-uscr time required 
01 -third level 

64 TSIF4 flags 

65 TSIB£N unused 

68 TSIIO I/O awaiting paging pointer 

6F TSIQCT quantum ctr 

70 TSIGQP master GQE pointer pageout 

74 TSITID task ID 

76 TSIXPR task external priority 

78 TSIPTS pages used last time slice 

7C TSIRVP reverse pointer 



Extended TSI (XTSI) 



CHAXTS 




00 


XTSUPS 


VPSW 


08 




unused 


10 


XTSCRS 


control regs 0-15 


50 


XTSGRS 


general regs 0-15 


90 


XTSFRS 


floating point regs 


B0 


XTSCTI 


current timer value 


B4 


XTSUTI 


user timer value 


B8 


XTSLTS 


last time slice value 


BC 


XTSAT1 


accumulated time 


CO 


XTSETI 


estimated time 


C4 


XTSTS1 


pointer to TSI 


C8 


XTSNPG 


number of pages this time slice 


CA 


XTSBYA 


bytes available 1st XTSI page 


CC 


XTSPCT 


page count XTSI 


CE 


XTSIC 


task interrupt code 


Dl 


XTSF1 


80 - XTSI has auxiliary storage 


D4 


XTSPTF 


first PTP in chain 


D8 


XTSPTL 


last PTP in chain 



42 



CONTENTS 

Expanded I/O interrupt controls ... 45 

Control registers ... 45 
2846 External machine check interrupt codes 
Machine check interruption (for DAT unit) . . 
Extended direct control ... 47 
Dynamic address translation ... 47 
Bit alignment of address arithmetic ... 49 
Formats of registers and entries ... 49 
Associative register format ... 50 



43 



APPENDIX 



EXPANDED I/O INTERRUPT CONTROLS 

Accomplished by using 16 control registers together with interrupt 
information in PSWs 

Control Registers 

Register Bit Position Assignments 

segment table register (for dynamic address translation) 

1 unassigned 

2 translation exception address register 

3 unassigned 

4 extended mask registers for I/O channel masks, used with 
ext. PSW-bit 6: 

Bits 

0-6 CCU 1 channel masks 

7 CCU1 (summary) 
8-14 CCU2 channel masks 
15 CCU2 (summary) 
16-22 CCU3 channel masks 
23 CCU3 (summary) 
24-30 CCU4 channel masks 
31 CCU4 (summary) 

5 unassigned 

6 used with ext. PSW bit 13 

Bits 

0,1 machine check mask extensions for channel 

controllers 
2,3 reserved 
4-7 unassigned 

8 extended control mode 

9 configuration control bit; specifies when 
partitioning can take place 

10-23 unassigned 

24-31 external interruption masking (used with ext. 
PSW bit 7) 
Bit Interruption Source 





24 


timer 




25 


interrupt key 




26 


malfunction alert-CPU 1 (ext. sig. 2) 




27 


malfunction alert-CPU 2 (ext. sig. 3) 




28 


reserved (ext. sig. 4) 




29 


reserved (ext. sig. 5) 




30 


external interrupt-CPU 1, 2 (ext. sig. 6) 




31 


reserved (ext. sig. 7) 


7 


unassigned 




8-14 


partitioning sensing registers 


15 


unassigned 
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2846 EXTERNAL MACHINE CHECK INTERRUPT CODES 
(associated with external interrupts) 



CABI 


UABI 









I 


2 





1 


2 


3 1 4 1 5 


t: 


7 


FAULT1 PSW Bits 


Note 


21 


22 


23 


24 


:s 


26 


27 | 28 J29 


30 


31 


Multiple CPU 













1 











i CPL 

1 2 




3 4 


CABO Parity Check 

UABO Parity Check 

CABO and UABO 

Parity Checks 




























1 



1 




1 

1 








, CABO , 

P 1 2 


Multiple Channel 
Recognition 




1 


1 








1 Cha 

1 2 




3 4 5 6 


Storage Interface. 
Timeout 


2,4 


1 











1 











r— StorlD , 

4 2 1 


Channel Interface 

Timeout 


1 


J 














J 








r- Chan ID , 

4 2 1 


SAB Parity Check 


1,4 
5 


1 


CSW 

Store 


1 
1 





Prot 
Key 


ID 


SAB 


Mirk 




Invalid Address (CSW) 


1,6 


1 


1 


1 



















Multiple Storage Select 


1,4 


1 

















1 







Multiple CCU Faults 


3 


! 




1 




Prefix ID Parity Check 








3DP 


ID 1 


ID 2 


, 


r-ChanID , 

4 2 1 



Notes: 

1. Binary representation of recognized channel encoded. 

2. Binary representation of selected storage unit is encoded (storage A 
= 000, storage B = 001, etc.). 

3. PSW bits 22, 23, and 25-31 ignored. 

4. Storage-address-check signal returned to channel. 

5. Bit 22 set 1 if indicated check detected during CSW store operation. 

6. Invalid storage-address-check signal always returned to channel; CCU 
external machine check interruption occurs only if channel in 
CSW-store operation. 

MACHINE CHECK INTERRUPTION {for DAT unit) 

In addition to machine-check capability in table, "Time Sharing 
System/360 Interruption Codes," the 2067 performs machine-checks 
on dynamic address translation unit. Additional information about 
machine-check interruption is stored in first byte (bits 0-7) of 
translation-exception address register (control register 2). A 1-bit in 
translation exception address register will indicate conditions: 

Bit Condition 

More than one associative register contains identical 
information, or one comparing circuit at fault. 

1 One of three conditions: 

a) hardware error occurred; successful compare achieved with 
virtual address higher than addresses in segment table. 

b) software error; program interruption 16 occurred with 
address bus out bits 0-7 greater than segment table register 
(control register 0) bits 0-7. 

c) software error; program interruption 17 occurred with 
address bus out bits 12-1 9 greater than page table register bits 
0-7, 

2 Virtual address portion of translated address just stored in 
associative array does not compare with virtual address that 
should have been stored. 

3 Reset of load-valid bits in associative array unsuccessful. 

4 Parity of adder sum inconsistent with predicted parity. 

5 Parity of virtual address incorrect when received by associative 
array. 

6 Parity of data word from storage incorrect when received by 
dynamic address translation circuitry. 

7 Parity of instruction bits 8-15 incorrect when received by 
dynamic address translation circuitry. 
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EXTENDED DIRECT CONTROL 

Enables direct communication of interrupt control information 
between two CPUs; it uses the external interrupt signal masks in control 
register 6 of each CPU to determine responses to control information 
received when interrupts occur. The meaning of external interrupt 
signal masks depends on the CPU in which control register 6 resides. 
The write-direct assembler language instruction can be used to cause 
only external timing signal interrupts and external starts. 



Contr. reg. 6 
mask bit 


External 
signal 


Meaning in CR6, 
CPU1 


Meaning in CR6, 
CPU2 


24 


Timer 


Timer interrupt 
allowed 


Timer interrupt 
allowed 


25 


Interrupt 
key 


Interrupt key 


Interrupt key 


26 


2 


Not used 


Malfunction alert 
from CPU 1 


27 


3 


Malfunction alert 
from CPU2 


Not used 


28 
29 


4 

5 


Reserved for 
future use 


Reserved for 
future use 


30 


6 


External timing 
signal from 
CPU1 orCPU2 


External timing 
signal from 
CPU 1 or CPU2 


31 


7 


Not used 


Not used 



The control registers can be initialized by the load multiple control 

instruction. 

Write-direct can activate external interrupts signal 6 on the CPU to 

which it is directed, when control register 6, bit 30, is set to 1. 

DYNAMIC ADDRESS TRANSLATION 

Converts virtual storage address to physical storage addresses when the 
CPU is operating in extended PSW mode. 

Virtual Storage Addresses (VA) 

The virtual address operand is formed from the base address, index, 
and/or displacement, as determined by the instruction format. 



VIRTUAL STORAGE ADDRESS 






SEGMENT 
NUMBER 


PAGE NUMBER 


BYTE DISPLACEMENT 


7 8 1112 19 20 31 
PHYSICAL STORAGE ADDRESS 




BLOCK ADDRESS 


BYTE DISPLACEMENT 
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Conversion Technique 

1. User gets control, the origin or his segment table is placed in control 
register 0. 

2. The virtual address is passed to the DAT unit. 

A. Segment number (from VA) + segment table origin (from 
control register 0) = address of segment table entry, pointing to 
page table origin 

B. Page table origin (from segment table entry) + page number 
(from VA) = address of page table entry, containing physical 
page block address 

C. Physical page block address (from page table entry) + byte 
displacement (from VA) = real instruction address 



VIRTUAL INSTRUCTION ADDRESS 



SEGMENT 
NUMBER 



CONTROL REGISTER 



SEGMENT 

TABLE 

LENGTH 



SEGMENT 

TABLE 

ORIGIN 



PAGE 
NUMBER 



SEGMENT TABLE 



PAGE 
*-*] TABLE 
LENGTH 



PAGE 

TABLE 

ORIGIN 



PAGE TABLE 



BYTE 
DISPLACEMENT 



PHYSICAL 
PAGE -BLOCK 
ADDRESS 



REAL 

INSTRUCTION 

ADDRESS 



CONTROL 
BITS 



BLOCK 
ADDRESS 



BYTE 
DISPLACEMENT 
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BIT ALIGNMENT OF ADDRESS ARITHMETIC 

1. Computation of Segment Table Entry Address 



Bits 






(24 -bit mode) Meaning 


Remarks 


8-31 


Segment table origin 


Bits 26-31 con- 




(from control regis- 


sidered 




ter 0) 




8-11 


Added to logical 


Aligned with 26-29 




address of segment 


of segment table 




table (from virtual 


origin 




address) 




8=31 


Yields sum 


Segment table entry 
address (30-31, 
always 0) 


Bits 






(32-bit mode) Meaning 


Remarks 


8-31 


Segment table origin 
(from control regis- 
ter 0) 


26-3 1 considered 


0-11 


Added to logical 


Aligned with 18-29 




address of segment 


of segment table 




table (from 32-bit 


origin 




mode virtual address) 




8-31 


Yields sum 


Segment table entry 
address (30-31, 
always 0) 


2. Computation of Page Table Entry Address 


Bits 


Meaning 


Remarks 


8-31 


Page table origin (from 
segment table entry) 


3 1 considered 


12-19 


Added to logical address 


Aligned with 23-30 of 




of page (from virtual 


page table origin 




address) 




8-31 


Yields sum 


Page table entry address 
(31, always 0) 


3. Computation of Physical Address on Page 


Bits 


Meaning 


Remarks 


0-11 


Real physical page 
address (from page table 
entry) 


High-order portion 


20-31 


Displacement from virtual 
or logical address 


Low-order portion 


8-31 


Physical address of 
instruction 


Both portions 



FORMATS OF REGISTERS AND ENTRIES 

Bits Meaning Remarks 

1. Segment Table Register Format 



0-7 Segment table length* 

8-3 1 Segment tabic origin 



Number of 16-entry 
groups in segment table; 
all Q's = one group 
Segment table origin 
located on 64-byte 
boundary ; bits 26-3 1 
must be 
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2. Segment Table Entry Format: 

0-7 Page table length 

8-30 Page table origin 

3 1 Page table availability 



3. Page Table Entry (half word): 



0-11 
12 



Physical block address 
Page availability 



13-15 Control bits, reserved 



Number of entries in 
page table; all 0's = 
one entry; 1 = two 
entries; etc. 
Page table origin lo- 
cated on 2-byte boundary 
l=segment translation 
exception (program inter- 
rupt code 16) 



Starting addresses of page; 
l=page translation excep- 
tion (program interrupt 
code 17) 

Must be 000 or specifi- 
cation exception 
*Only for CPUs with 32-bit addressing feature 

To avoid repetition of address translation, page table entry (physical 
page starting address, bits 0-11) is recorded in an associative register 
with, and identified by, its virtual storage address (segment and page 
table number, bits 8-19 of VA); eight associative registers are used by 
DAT unit, with this format: 



ASSOCIATIVE REGISTER FORMAT 



24-bit addressing 




Bits 


Content 


Remarks 


8-19 


Virtual address 




20-31 


Physical address 


Page address from previous 
translation that corresponds 
to virtual address in bits 
8-19 


32-35 


Unassigned 




36 


Register valid 


Set to 1, on loading the 
register 


37 


Recent usage, "Load" 


Set to 1, on loading the 



register and on any use 
thereafter 
38 Disable Set with special diagnostic 

codes 8-15 
32-bit addressing 

same as above except for virtual address; in bits 0-19. 
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